home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / extra_2 / tar320f_.zip / TAR.TXT < prev    next >
Text File  |  1995-07-08  |  33KB  |  852 lines
  1. 'tar' - is an acronym for 'tape archiver'
  2.  
  3. It is a tool to save files to archive media and restore them back
  4. again. Despite of its name, the program handles many media types,
  5. be it a floppy disk or regular file.
  6.  
  7. The program was initially written for UNIX operating system, but
  8. since many other OS support its format, tar became a useful tool
  9. for information exchange between different platforms.
  10.  
  11. This document describes yet another implementation of the program,
  12. which could be noted for portability between MS-DOS and UNIX
  13. clones, portability both in data format and source text level.
  14.  
  15.  
  16.     System requirements
  17.  
  18. Program will execute
  19.  - on any IBM PC compatible computer running MS-DOS 3.0 or
  20.    compatible OS;
  21.  - any generic UNIX clone.
  22.  
  23. Before running the program you will probably have to compile it,
  24. especially if you are a UNIX user. To do that you should have:
  25.  - any C compiler compatible with K&R or ANSI standard - for
  26.    UNIX version;
  27.  - Turbo C v2.0 under MS-DOS 3.30 - for DOS version.
  28.  
  29. Declaring such a wide portability shall probably have some
  30. restrictions, but, alas, I do not know about them.
  31.  
  32. The size of free memory required for program depends of the action
  33. selected. As a rule, about 100K bytes is enough to read/write
  34. archives without compression. If you are going to use compression
  35. options, the program can take all the megabytes available.
  36.  
  37. Anyway, the program will be able to process archive in a regular
  38. file (see below). It also supports floppy diskettes and streamer
  39. tape devices of several types under MS-DOS. Media types available
  40. under UNIX is determined by device drivers available in the
  41. system.
  42.  
  43.  
  44.     Running the program
  45.  
  46. The program can be run simply from command line. You have to type
  47. to the system prompt a line with the following syntax:
  48.  
  49.     Tar <options> <file> ...
  50.  
  51. where options define both action to perform and some additional
  52. options. You have to specify at least one option to define
  53. action, and command line must contain only one action option.
  54.  
  55. Options could written in two forms.
  56. First one is traditional for UNIX: each option is represented by
  57. single character, character may be merged in groups, preceded by
  58. minus (-) sign.
  59. Second form became popular in recent times: each option is
  60. represented by word, word options are preceded by plus or double
  61. minus sign to distinguish them from group of character options.
  62.  
  63. Command line parameter (save first) without first plus or minus
  64. sign denotes end of option and start of file specification list.
  65. File specifications may be omitted for reading archive
  66. (extraction files or printing archive contents) in this case the
  67. program will process all the files in archive; other options makes
  68. the list obligatory.
  69.  
  70. For compatibility with old implementations of tar first command
  71. line parameter (if it is not an word option) is always treated as
  72. group of single-character options.
  73.  
  74. Some options require subsequent parameters such as numerical value
  75. or a file name, in the latter case parameters must follow the
  76. option or option group separated by spaces. Parameters following
  77. the group of character options must be specified exactly in the
  78. same order as the options they follow - be careful.
  79.  
  80. The following is a list of options along with their descriptions
  81. (unlike most other implementations this program is case
  82. insensitive, i.e., makes no difference between upper and lowercase
  83. letters). Options are mentioned with both single-character and
  84. word form (if any). Word options are distinguished by first eight
  85. character, they also may be shortened down to minimum number of
  86. characters needed to distinguish them; if the beginning of word
  87. option matches two (or more) options the program will choose one
  88. of them according to its own tastes.
  89.  
  90. -a, +append - add (store) files to archive, the option is fully
  91.     analogous to traditional 'r' option, and was added to user
  92.     convenience.
  93.     You have to specify the list of files to be stored.
  94.     Note, that normally files are appended to the end of
  95.     archive, so the archive can contain several files with the
  96.     same name; by default, the program will extract the latest
  97.     version. Such a behavior may be changed by 'c', 'd' and
  98.     'w' options.
  99.  
  100. -x, +extract - extract files from archive; program extracts
  101.     specified files, if no file name is given, the whole
  102.     archive will be extracted. If the directory name appears
  103.     in command line, the program extracts all of the files and
  104.     subdirectories in a given directory.
  105.  
  106. -t, +list - type archive directory. The files to be processed are
  107.     defined as for the 'x' command.
  108.     The program outputs list of file names, unless 'v'
  109.     modifier is given. With 'v' option each file name is
  110.     preceded by its UNIX access rights mask, numeric user and
  111.     group identifiers and file length in bytes. Usage with 'e'
  112.     or 'z' option forces printing both compressed and original
  113.     file lengths.
  114.  
  115. -d, +delete - the specified files will be deleted from archive;
  116.     this option is for file archives only.
  117.  
  118. -r - read files from disk to archive; the option is an alias for
  119.     'a', it is preserved for the compatibility reasons.
  120.  
  121. -c, +create - the 'a' option implies that archive media contains
  122.     an existing tar archive, or archive file already exists.
  123.     The 'c' option creates a new archive or overwrites old one
  124.     (if any). This option also implies 'a' so you do not need
  125.     to specify it.
  126.  
  127. -y, +move - delete files and directories after storing them into
  128.     archive. This option implies 'a'.
  129.  
  130. -u, +update - update archive. Normally program stores all of the
  131.     files specified. Given option causes tar to store files
  132.     only if they are not present in archive or if the files
  133.     were modified.
  134.     This option implies 'a'.
  135.  
  136. -i, +inhibit - ignore read errors. This option may help (but may
  137.     not) to restore damaged archive.
  138.  
  139. -v, +verbose - normally program works silently; this option forces
  140.     printing of a log with most operations or produces a lot
  141.     of additional information with 't' option.
  142.  
  143. -w, +interactive - the program will ask for your confirmation
  144.     before processing each file.
  145.  
  146. -e, +zip-files - apply a 'deflate' compression to archive files.
  147.     Single-character form allows to specify compression level
  148.     by the single digit immediately after 'e' letter; legal
  149.     values are from 1 to 9 (e.g. e9 - the more compression
  150.     level, the better compression ratio will be - default is
  151.     6); note, that this rule does not follow regular command
  152.     line syntax.
  153.     Keep in mind that you won't be able to restore the
  154.     compressed file by standard 'tar' program.
  155.     Portable tar version 3.15 or below uses another kind of
  156.     data compression. Current version allows restoring of old
  157.     archives, but the archives created by current version of
  158.     the program with -e option would not be restored by
  159.     previous versions.
  160.  
  161. -z - compress files in archive with traditional UNIX algorithm.
  162.     It is compatible with most Unix systems, so you can
  163.     extract files with 'uncompress' or even 'tar' program
  164.     alone, but this algorithm has comparatively low
  165.     compression ratio. You may specify 'bits' factor typing it
  166.     immediately after z letter (e.g. z12); note, that this
  167.     rule does not follow regular command line syntax.
  168.     See 'compress' program manual to understand 'bits' factor
  169.     meaning.
  170.  
  171. -, (comma), +compress - this option is similar to 'z', but the
  172.     whole archive will be (de)compressed rather than
  173.     individual files.
  174.  
  175. -. (dot), +zip-archive - this option is similar to ',' (comma) and
  176.     allows to read and create deflated archive in regular zip
  177.     or GNU zip format. It's possible to specify compression
  178.     level for created archive by the single digit immediately
  179.     after dot sign; legal values are form 1 to 9 (the more
  180.     compression level, the better compression ratio will be).
  181.  
  182. -s, +strict - program will not process '?' and '*' wildcards in
  183.     archive file names.
  184.  
  185. -m, +modification-time - sets modification time of files to
  186.     current time. By default the program sets date and time of
  187.     modification for extracted files exactly as they have
  188.     before they have been placed into archive.
  189.  
  190. -o - option meaning depends on the host operating system, namely
  191.      under UNIX it means -
  192.     omit files owner. By default program tries to restore
  193.     original files owner and group. The option forces tar to
  194.     set the user who invokes tar as files owner, which is
  195.     especially useful when files are marked with zero owner,
  196.     i.e. 'root'.
  197.      under DOS respectively -
  198.     prevent files overwriting. There exists a chance that two
  199.     or more UNIX files will have same DOS names, so they
  200.     couldn't co-exist onto DOS disk. If the 'o' option given,
  201.     the program will rename extracted file if there is a file
  202.     on the disk with the same name. This option can also
  203.     affect multivolume processing. Namely, if two different
  204.     UNIX files have same DOS names and second file is
  205.     fragmented between volumes then extents of the second file
  206.     will be appended to first one. Alas, I see no solution for
  207.     this problem.
  208.  
  209. -l - option meaning depends on the host operating system, namely
  210.      under UNIX (equivalent is +link-warnings) it means -
  211.     print list of files being archived, which have other links
  212.     besides those placed in archive.
  213.      under DOS (equivalent is +link-copy) respectively -
  214.     make copies of linked files to simulate UNIX links
  215.     (otherwise the program will extract first copy only and
  216.     print warning messages on the others).
  217.  
  218. -p, +permissions - save in archive directories info (e.g. owner
  219.     and permissions) as well as files.
  220.  
  221. -n, +nonest - no directory nesting. The program will not recurs
  222.     into subdirectories.
  223.  
  224. -/ for UNIX or -\ for DOS - omit left <back>slash in file names.
  225.  
  226. -: (colon) - omit MS-DOS drive name from file name.
  227.  
  228. -j, +comment - you will be prompted to add file comment while
  229.     storing; this comment will be shown by 't' option. Note,
  230.     that used implementation of this option is incompatible
  231.     with P1003 standard, so I had to choose between either
  232.     standard or backward compatibility. In any case you'd
  233.     better avoid this option.
  234.  
  235. -f, +file - this option requires an argument - a name of archive
  236.     file or special file.
  237.     By default, program tries to get a file name from 'TAPE'
  238.     environment variable. If no archive name is given, tar
  239.     tries to handle floppy disk under MS-DOS or to use
  240.     /dev/mt0 under UNIX.
  241.     File names are also used to support hardware devices, i.e.
  242.     floppy disks and streamers. See section 'Special files'
  243.     below.
  244.     You also can store default file name (without 'f' option
  245.     itself) into 'TAPE' environment variable - this is
  246.     especially useful with streamer devices.
  247.     The name consisting of single minus sign stands for
  248.     standard input/output. This is UNIX convention and it is
  249.     better to avoid this possibility under MS-DOS.
  250.  
  251. -k - this option requires an argument, storage media capacity.
  252.     Capacity units may be specified by letter after numerical
  253.     value: 'k' - kilobytes (default) or 'm' - megabytes
  254.     (currently useless).
  255.     Although the program tries to adjust appropriate diskette
  256.     type for a given hardware, you often will not be able to
  257.     read or write floppies without defining its type.
  258.     This option is not applicable in UNIX version.
  259.  
  260. -b, +block-size - this option requires an argument, so called
  261.     'blocking factor'. Block size units may be specified by
  262.     letter after numerical value: 'b' - 512-bytes blocks
  263.     (default) or 'k' - kilobytes. This program allows blocking
  264.     factor in the range of 1 to 32 (512 bytes to 16K
  265.     respectively). The sense of the option is rather tricky.
  266.     Big blocking factor allows to save much space on some tape
  267.     devices, but if you are going to transfer data between
  268.     different computers I strongly recommend not to use
  269.     blocking factor more than 16. Note, that original tar does
  270.     not allow values more than 20.
  271.     In general this option does not influence the resulting
  272.     archive with floppy devices or regular files, but
  273.     appropriate value can dramatically increase tar speed.
  274.     Except floppies this program adjust the most appropriate
  275.     blocking factor, so you do not need to use this option,
  276.     but it is also possible that you will not be able to
  277.     restore files without setting properly the value for a
  278.     given archive.
  279.     Optimum blocking factor for floppies is multiple of
  280.     number of sectors per track. Unfortunately some BIOSes
  281.     requires small bloksizes, so you should try optimum value
  282.     with your system.
  283.  
  284. [0-9] single digit stands for the number of storage device;
  285.     e.g. 1 means MS-DOS drive B: or second streamer tape.
  286.  
  287. -@ - this option requires an argument - a name of file, containing
  288.     the continuation of a command line. This option allows tar
  289.     to read a list of file specification from a separate file.
  290.     As above, a file name consisting of single minus means
  291.     standard input. The size of input defined by this option
  292.     must not exceed 32760 bytes.
  293.  
  294. -#, +exclude - this option requires an argument - specification of
  295.     files which must not be processed (excluded from the
  296.     operation). Specification may be simple file name or it
  297.     can contain * and ? wildcards (unless 's' option given).
  298.     Keep in mind that these wildcards will be processed in
  299.     UNIX style.
  300.     This option may occur up to 16 times in a command line,
  301.     each occurrence introduce another specification (count
  302.     carefully!)
  303.  
  304. +gnu or +gzip - this option causes tar to create deflated archive
  305.     in gzip format (rather than regular zip) with -. (dot)
  306.     option. This option itself does not imply compression, so
  307.     you must specify dot explicitly if needed.
  308.  
  309.  
  310.      Special files
  311.  
  312. Special files (also called 'device drivers') are widely used in
  313. UNIX to interact with hardware devices. There are no useful
  314. special files under MS-DOS (oh, of course you can create an
  315. archive at 'nul', it will go to the neverland), but DOS version
  316. supports its own internal special file names.
  317.  
  318. Common notices:
  319. 1. If you want to process a disk file which name coincides with
  320.    tar special file simply supply dot in a file name.
  321. 2. If the computer has two storage devices of same kind, the
  322.    actual device used by program is determined by both special
  323.    file name and single-digit option (see above).
  324.    Regardless of native enumeration tar devices always counted
  325.    from zero (0 means floppy drive A: or first QIC-02 streamer
  326.    etc.)
  327.  
  328. Tar special files are divided into three groups.
  329.  
  330. The following file names designate floppy devices:
  331.    fd048ss8, fd048ds8, fd135ds9, fd048ss9, fd048ds9, fd135ds18,
  332.    fd096ds9, fd096ds15, rainbow
  333. Such a "file name" consists of the following components:
  334.  - device type, e.g 'fd';
  335.  - floppy radial density, e.g. 048, 096 or 135 tracks per inch;
  336.    first two relate to 5.25" floppies, the last is for 3.5" disks;
  337.  - number of working surfaces: ss means 'single side' while
  338.    ds - 'double side';
  339.  - the last value is a number of sectors per track.
  340. Note, that usually you do not need to use this mechanism, it could
  341. be better to set 'k' option instead.
  342.  
  343. The last name, "rainbow", is for disks in DEC Rainbow format; it
  344. has no equivalent options. For better hardware compatibility it is
  345. recommended to format such disks on the PC they will be read or
  346. written. There exists a couple of PC programs, which allow such
  347. formatting.
  348.  
  349. The second group of special file names refers to QIC-02 streamer
  350. tape devices. Be aware that you have QIC-02 device, since the
  351. program does not support for example floppytape devices.
  352.  
  353. Since streamers have no standard software interface like BIOS it's
  354. necessary to mention device hardware configuration in a command
  355. line (or 'TAPE' environment variable).
  356. So, streamer 'file name' have a complex syntax, it includes
  357.  - device name itself, followed by
  358.  - separator - colon or semicolon - and
  359.  - parameter list.
  360.  
  361. The parameter list consists of parameter groups separated by
  362. commas, semicolons or dots (there is no difference).
  363.  
  364. Each parameter group (save 'norewind' or 'add' parameters - see
  365. below) in turn consists of keyword followed by assignment (:=) and
  366. some value.
  367.  
  368. The program recognizes three device names:
  369.     Archive, Everex and Wangtek
  370. Each name means device clone name and corresponds to plenty of
  371. device brands. Most of existing QIC-02 streamers belongs to one of
  372. the above three types.    The names of the clones are borrowed from
  373. the trademarks of their respective manufacturers but keep in mind
  374. that there is no strict rule (e.g. Archive corporation produced
  375. streamers that fits to Everex clone). Usually you have test you
  376. streamer with different device names to select appropriate one.
  377.  
  378. Parameter list may include the following options (most of them
  379. concerns to hardware, so consult you streamer documentation):
  380. base:=<sexadecimal value> - IO base address,
  381.      this is the only obligatory parameter;
  382. dma:=<octal digit> - DMA channel number;
  383.      there is a rumor about devices without DMA, but I have not
  384.      seen one, so usually you have to use this option;
  385. irq:=<decimal number from 0 to 15> - interrupt request number;
  386.      as a rule you do not need to use this option, but it may or
  387.      may not solve hardware problems, such as
  388.      - another device uses same interrupt request number,
  389.      - your system BIOS has no default handler for hardware
  390.        interrupts;
  391. qic:=<QIC standard number> - defines tape format/capacity,
  392.      valid QIC numbers are 11, 24, 120, 150, 300, 600, 2100
  393.      and 2200;
  394.      first four formats may also be specified by corresponding
  395.      number of tracks as
  396. tracks:=<decimal number>
  397.      Note, that most streamer devices can not support all this
  398.      formats; since the program can not detect formats supported
  399.      you should yourself care of proper tape format. Fortunately
  400.      most streamers detect format of existing data or set its
  401.      default format for writing, so as a rule you do not need in
  402.      this option at all.
  403. norewind - this option is supplied to maintain several archives
  404.      on a single tape. (Note that QIC-02 standard does not allow
  405.      to add files into existing tar archives. This program
  406.      includes an option to do that, but it is possible that
  407.      hardware disables it. You do allowed to handle several
  408.      archives on a tape, but keep in mind that it is not allowed
  409.      by some UNIX systems).
  410. skip:=<decimal number>
  411.      skip given number of file marks before processing archive.
  412.      This is yet another option to keep several archives on tape.
  413.      (This option must be - and will be - implemented as a command
  414.      line switch rather than device parameter.)
  415. add - position tape at end of recorded data before processing
  416.      archive. This is yet another option to keep several archives
  417.      on tape. This options use command marked as 'optional' by
  418.      QIC-02 standard, so it may not work with your device - in
  419.      such case use 'skip' or 'norewind' instead.
  420.      (This option must be - and will be - implemented as a command
  421.      line switch rather than device parameter.)
  422.  
  423. Unlike device name, parameters may be shortened, it is possible to
  424. mention as many (few) letters from keyword as you like or omit any
  425. part - ':' or '=' - of the assignment sign or both of them (see
  426. example below).
  427.  
  428. The only blocking factor allowed by all QIC-02 devices is 1 - and
  429. it is default value for streamer tape in this program. Unlike many
  430. other implementations which fragments large logical block into
  431. small physical pieces, you are allowed to change the physical
  432. block size, but I have no idea about results.
  433.  
  434. Third group of special files include three names: ASPI, ASPIMGR$
  435. and ASPITape. All these names are aliases for ASPI-driven SCSI
  436. tape drives (streamers). To use this feature you must have
  437. previously installed ASPI driver in your system.
  438.  
  439. ASPI is an acronym for Advanced SCSI Programming Interface.
  440. ASPI specifications are property of Adaptec Inc., and ASPI itself
  441. is current de-facto standard to control SCSI devices under DOS.
  442. All ASPI drivers I've ever seen are copyrighted commercial
  443. products, so ASPI driver may not be supplied with this program.
  444.  
  445. Like QIC-02 devices, special file name may include parameter list
  446. with syntax described above, but all the parameters are optional.
  447. By default the program asks ASPI manager for a tape device (tape
  448. device with given sequential number if specified by single-digit
  449. command line option). If you specify single-digit command line
  450. option you may not use anything from adapter-target-LUN triple
  451. and vice versa.
  452.  
  453. Parameter list may include the following options:
  454. adapter:=<digit> - host adapter number (0, 1 etc.);
  455. target:=<octal digit> - target number (see SCSI specifications
  456.     and/or hardware manual for more info);
  457. lun:=<octal digit> - logical unit number (see SCSI specifications
  458.     and/or hardware manual for more info);
  459. density:=<value> - SCSI density code, may be specified as decimal
  460.     or hexadecimal value (using C or Assembly language
  461.     notation); legal values are from 0 to 255,
  462.     SCSI standard definitions are summarized in the following
  463.     table:
  464.  
  465.     0x0  default for device
  466.     0xE  reserved for ECMA
  467.  
  468.     Value Tracks Density(bpi) Code Type Reference      Note
  469.     0x1    9    800      NRZI    R   X3.22-1983      2
  470.     0x2    9      1600      PE    R   X3.39-1986      2
  471.     0x3    9      6250      GCR    R   X3.54-1986      2
  472.     0x4    4/9     8000      GCR    C   QIC-11      1,4
  473.     0x5    4/9     8000      GCR    C   X3.136-1986   1
  474.     0x6    9      3200      PE    R   X3.157-1987   2
  475.     0x7    4      6400      IMFM    C   X3.116-1986   1
  476.     0x8    4      8000      GCR    CS  X3.158-1986   1
  477.     0x9    18     37871      GCR    C   X3B5/87-099   2
  478.     0xA    22      6667      MFM    C   X3B5/86-199   1
  479.     0xB    4      1600      PE    C   X3.56-1986      1
  480.     0xC    24     12690      GCR    C   HI-TC1      1,4
  481.     0xD    24     25380      GCR    C   HI-TC2      1,4
  482.     0xF    15     10000      GCR    C   QIC-120      1,4
  483.     0x10   18     10000      GCR    C   QIC-150      1,4
  484.     0x11   26     16000      GCR    C   QIC-320(525?) 1,4
  485.     0x12   30     51667      RLL    C   QIC-1350      1,4
  486.     0x13    1     61000      DDS    CS  X3B5/88-185A  3
  487.     0x14    1     43245      RLL    CS  X3.202-1991   3
  488.     0x15    1     45434      RLL    CS  ECMA TC17      3
  489.     0x16   48     10000      MFM    C   X3.193-1990   1
  490.     0x17   48     42500      MFM    C   X3B5/91-174   1
  491.  
  492.     where Code means:
  493.     NRZI Non Return to Zero, change on ones
  494.     GCR  Group Code Recording
  495.     PE   Phase Encoded
  496.     IMFM Inverted Modified Frequency Modulation
  497.     MFM  Modified Frequency Modulation
  498.     DDS  Dat Data Storage
  499.     RLL  Run Length Encoding
  500.  
  501.     where Type means:
  502.     R    Reel-to-Reel
  503.     C    Cartridge
  504.     CS   cassette
  505.  
  506.     where Notes means:
  507.     1    Serial Recorded
  508.     2    Parallel Recorded
  509.     3    Helical Scan
  510.     4    Not ANSI standard, rather industry standard.
  511.  
  512. code:=<value> - alias for "density";
  513. qic:=<number> - functional equivalent to density code, allows to
  514.     specify tape format accordingly to QIC number; valid
  515.     numbers are 11, 120, 150, 320, 525 and 1350;
  516. skip:=<decimal number> - skip given number of tape markers, see
  517.     QIC-02 devices for details;
  518. norewind - see QIC-02 devices for details;
  519. erase - erase the whole tape before processing;
  520. fluent - do not reset device: some hardware and/or ASPI drivers
  521.     can't handle software reset properly, in such a case
  522.         try this option.
  523.  
  524. Hint:    try to specify as few parameters as possible.
  525.     Aspitape in most cases will work without any parameter.
  526.  
  527. GENERIC WARNING: I made all possible efforts to provide robust
  528. hardware interface, but I have no means to make it 100% reliable.
  529. So BEFORE storying any useful information, please check that data
  530. written by this program can be read afterwards.
  531.  
  532.  
  533.      Environment variables
  534.  
  535. Program encounters the following environment variables:
  536.  
  537. TAPE -    if set, contains a default archive file name (an argument
  538.     for -f option) and is especially useful for streamer names
  539.     with complicated syntax;
  540. TARCMD - is intended to provide default settings, namely, if the
  541.     string pointed to by this variable begins with
  542.     - slash under UNIX
  543.     - backslash or letter, colon and backslash under DOS
  544.     it is considered the name of file, containing default
  545.     command line for the program; in other case it is treated
  546.     as the command line itself.
  547.     It would be a good idea always precede command line
  548.     options by minus to avoid ambiguity (e.g. 'c:\file' is
  549.     valid command-line option under DOS).
  550.     Note, there is no way to annul these default options.
  551. TZ -    if set, contains timezone settings; if this variable do
  552.     not set or set improperly files will be placed in archive
  553.     with wrong timestamps, nevertheless, you will not see
  554.     anything bad until you read files on another computer or
  555.     OS. TZ variable built accordingly rules described in
  556.     relevant documentation but displacement from GMT would be
  557.     enough (four digits for hours and minutes preceded by
  558.     sign, e.g. Moscow timezone setting TZ=MSK-3MSD is
  559.     equivalent to TZ=-0300 during winter).
  560.  
  561.  
  562.      Examples
  563.  
  564. List file names in archive anyfile.tar:
  565.     Tar tf anyfile.tar
  566.  
  567. Print verbosely directory of 1.2M floppy in drive B:
  568.     Tar tv1k 1200
  569.  
  570. Store all files from given list to tape, as dense as possible:
  571.     Tar cvbf.9 32 /dev/tape +g -@ listfile.s
  572.  
  573. Extract all files from streamer cartridge (in DOS), hardware
  574. chosen as IO base address 300h, DMA channel 1 and QIC-24 tape
  575. format:
  576.     Tar -xvf archive:b300,dma:=1,t:9
  577.  
  578.  
  579.      Compiling the program
  580.  
  581. Before doing this, you need to have a properly installed C
  582. compiler.
  583.  
  584. Place program sources into separate directory, then
  585.  - type !compile at the DOS prompt to build DOS version.
  586.  - issue make command to build UNIX version.
  587.  
  588. Note: if you work under ISC UNIX or another System V, you should
  589.       try 'make -f makefile.ix' command to decrease size of the
  590.       executable file.
  591.  
  592.  
  593.       Diagnostics
  594.  
  595. Can only handle XX bits. Continue?
  596.     Not enough RAM to perform un/compression with desired
  597.     bits factor (either default or specified). You will be
  598.     prompted to continue with maximum possible bits factor.
  599.  
  600. Diskette capacity XXXK assigned
  601.     Since you have not specified diskette capacity, the
  602.     program informs you about its choice.
  603.  
  604. Extract anyway?
  605.     Archive file can not be uncompressed due to some reason
  606.     and you are prompted to extract its compressed image.
  607.  
  608. File compressed with XX bits, can only handle XX bits.
  609.     Archive file can not be uncompressed for the current bits
  610.     factor is less than the factor during compression.
  611.  
  612. File is not in compressed format
  613.     Although archive has '.Z' suffix, its structure does not
  614.     match compressed one. Thus, the file can not be
  615.     uncompressed and you will be prompted to extract it as is.
  616.  
  617. No memory for encoding. Continue?
  618.     Files can not be packed due to lack of free memory. You
  619.     are prompted to store them unpacked.
  620.  
  621. Tar: XXX blocks skipped to find header
  622.     Archive corrupted, skipped blocks possibly contains lost
  623.     information.
  624.  
  625. Tar: '...' checksum error
  626.     Checksum algorithm fails while unpacking the file.
  627.     The data is probably corrupt.
  628.  
  629. Tar: '...' decode error
  630.     Internal compressor error.
  631.  
  632. Tar: '...' decreased size
  633.     File decreased size while the program stored it.
  634.  
  635. Tar: '...' exceeds limit in size
  636.     Input for '@' option exceeds 32760 bytes in size.
  637.  
  638. Tar: '...' name too long
  639.     The name of file in archive must not exceed 100
  640.     characters.
  641.  
  642. Tar: '...' seek error
  643.     Error processing file.
  644.  
  645. Tar: 'm' and 'u' options ambiguous
  646.     Do you really want both this options?
  647.  
  648. Tar: archive unchanged
  649.     There was no job for 'u' or 'd' options.
  650.  
  651. Tar: bad blocksize (max is 32)
  652.     The program allows block factor in the range of 1 to 32.
  653.  
  654. Tar: bad directory structure
  655.     Archive is corrupted (file header error).
  656.  
  657. Tar: bad option '?'
  658.     Invalid character in option string.
  659.  
  660. Tar: base address must be specified
  661.     Error in streamer parameters (DOS only).
  662.  
  663. Tar: blocksize = XX
  664.     Since you have not specified block factor, the program
  665.     informs you about its choice.
  666.  
  667. Tar: blocksize multiply defined
  668.     You have specified block factor more than once.
  669.  
  670. Tar: can't access '...'
  671.     Error processing file.
  672.  
  673. Tar: can't create '...'
  674.     Error processing file, probably the file system at your
  675.     computer is full.
  676.  
  677. Tar: can't create directory '...'
  678.     Error processing file, probably the file system at your
  679.     computer is full.
  680.  
  681. Tar: can't create scratch file
  682.     Error processing file, probably the file system at your
  683.     computer is full.
  684.  
  685. Tar: can't delete '...'
  686.     Error processing file.
  687.  
  688. Tar: can't delete scratch file
  689.     Error processing file, this usually does not mean tar lost
  690.     some data, but it indicates some filesystem problem.
  691.  
  692. Tar: can't find '...'
  693.     No file matches given wildcard specification (DOS only).
  694.  
  695. Tar: can't handle '...'
  696.     Error processing file.
  697.  
  698. Tar: can't link '...' - data stay in '...'
  699.     The program can not restore links properly (UNIX only).
  700.  
  701. Tar: can't link '...'
  702.     The program can not restore links properly (UNIX only).
  703.  
  704. Tar: can't open '...'
  705.     Probably the file given does not exist or access denied.
  706.  
  707. Tar: can't open directory '...'
  708.     Error processing directory, probably access denied.
  709.  
  710. Tar: can't open file '...'
  711.     Probably the file given does not exist or access denied.
  712.  
  713. Tar: can't process '...'
  714.     Error processing file.
  715.  
  716. Tar: can't read '...'
  717.     Error processing file.
  718.  
  719. Tar: can't remove '...'
  720.     The directory mentioned can not be deleted.
  721.  
  722. Tar: can't rename '...' to '...'
  723.     Error performing 'd' option, archive stayed unchanged.
  724.  
  725. Tar: can't update stdout
  726.     You may not apply given option to standard output.
  727.  
  728. Tar: delete option is for file archives only
  729.  
  730. Tar: device parameter error
  731.     Error in streamer parameters (DOS only).
  732.  
  733. Tar: directory checksum error
  734.     Archive is corrupted (file header error).
  735.  
  736. Tar: diskette error: ...
  737.     Probably the diskette is corrupted.
  738.  
  739. Tar: drive not present
  740.     You have specified diskette drive which does not exist
  741.     (DOS only).
  742.  
  743. Tar: error extracting '...'
  744.     Error processing file. Possible reason: there is no space
  745.     left on the hard disk.
  746.  
  747. Tar: error processing '...'
  748.     Error processing file.
  749.  
  750. Tar: error reading '...'
  751.     Error processing file.
  752.  
  753. Tar: error shrinking memory block
  754.     Internal runtime error.
  755.  
  756. Tar: fault run mkdir!
  757.     The 'mkdir' command was not found in /bin, /usr/bin and
  758.     /etc directories (UNIX only).
  759.  
  760. Tar: fault run rmdir!
  761.     The 'rmdir' command was not found in /bin, /usr/bin and
  762.     /etc directories (UNIX only).
  763.  
  764. Tar: incompatible options
  765.  
  766. Tar: input must be free
  767.     It is not allowed to use standard input with 'f' option
  768.     and any of 'w' or 'j' options.
  769.  
  770. Tar: insert NEXT diskette and press ENTER when ready...
  771.     You are prompted to continue multivolume archive
  772.     processing.
  773.  
  774. Tar: invalid base address
  775.     Error in streamer parameters (DOS only).
  776.  
  777. Tar: invalid bits factor
  778.     The bits factor must be in range of 12 to 16.
  779.  
  780. Tar: invalid character after 'X'
  781.     Error in streamer parameters (DOS only).
  782.  
  783. Tar: invalid diskette size
  784.     Allowed arguments for 'k' option are: 160, 180, 320, 360,
  785.     720, 1200, 1440, 2880 (DOS only).
  786.  
  787. Tar: invalid DMA channel number
  788. Tar: invalid IRQ number
  789. Tar: invalid number of tracks
  790. Tar: invalid QIC number
  791.     Error in streamer parameters (DOS only).
  792.  
  793. Tar: missed XX link(s) to '...'
  794.     The file has multiple links and given number of them were
  795.     not stored in the archive; you will not see this message
  796.     unless 'l' option is given (UNIX only).
  797.  
  798. Tar: no files specified
  799.  
  800. Tar: no memory to unpack.
  801.     You will be prompted to extract packed image.
  802.  
  803. Tar: not enough memory to uncompress
  804.     You will be prompted to extract compressed file.
  805.  
  806. Tar: not enough memory
  807.  
  808. Tar: nothing to do
  809.     You have to specify either 'a', 'x', 't' or 'd' option.
  810.  
  811. Tar: out of memory; link(s) lost
  812.     Not enough memory to keep list of links, links will be
  813.     stored in archive as a separate files (UNIX only).
  814.  
  815. Tar: tape blocksize error
  816.     Error processing archive.
  817.  
  818. Tar: tape close error
  819.     Error processing archive.
  820.  
  821. Tar: tape device multiply defined
  822.     You have specified ambiguous options.
  823.  
  824. Tar: tape read error
  825.     Error processing archive.
  826.  
  827. Tar: tape seek fault
  828.     Error processing archive.
  829.  
  830. Tar: tape write error
  831.     Error processing archive. Possible reason: there is no
  832.     space for archive file on hard disk.
  833.  
  834. Tar: unknown parameter '...'
  835.     Error in streamer parameters (DOS only).
  836.  
  837. Tar: unsupported hardware configuration
  838.     That is (DOS only).
  839.  
  840. Tar: warning: bad sector XXX, skipped
  841.     The sector has physical defects, tar has skipped it.
  842.     Note: you will not be able to read such a diskette on
  843.     another computer (DOS only).
  844.  
  845. Tar: warning: can't open terminal device, may be problems
  846.     Standard input is used for 'f' or '@' option and the
  847.     program can not open terminal device
  848.     (/dev/tty - UNIX only).
  849.  
  850. Tar: warning: renamed to '...'
  851.     UNIX file name was changed according to DOS rules.
  852.